Popular Request

home *** CD-ROM | disk | FTP | other *** search

/ Popular Request / By Popular Request (Arsenal Computer)(SysOptics Distribution System).ISO / amiga2 / logg20.lha / 2.0 / LoGG.doc < prev next >

Wrap

Text File | 1994-02-26 | 57KB | 1,011 lines

HERMES' LoGG (Version 1.2) Copyright (c) 1991-94 A. G. Kartsatos Shareware ========= IF YOU USE THIS PROGRAM, PLEASE SEND US$30.00 TO: A. G. KARTSATOS 8524 CALADESI ISLAND DRIVE TAMPA, FL 33637-7310, USA This program is one of the best utility programs for the Amiga computer. It was written by HERMES who has been writing utilities for the Amiga computer for the past 5 years. It is geared towards the average Amiga user. The graphics were kept to an absolute minimum so that more utilities would be included. Its flexibility and the multitude of its applications make it a unique tool for the manipulation of files. It will handle up to 1600 files in high resolution and 800 files in medium resolution. It has 48 built-in utility gadgets and 48 user-definable gadgets. It provides considerable help to the user for the most important archi- ving functions. It will recognize the 14 functions: ARC, UNARC, LISTARC, LHARC, UNHARC, LISTHARC, PAK, UNPAK, LISTPAK, ZOO, UNZOO, LISTZOO, WARP, UNWARP, provided that the user has the appropriate archiving utilities in his/her current "c" directory. It has a built-in HEX EDITOR that allows you to edit binary files in HEX as well as ASCII modes. It has a built-in SPEECH utility with which you can hae any phrase translated and spoken under various values of the variables involving speech and sound characteristics. It has a built-in SHOW routine that will recognize all IFF pictures, including OVERSCAN pictures and BRUSHES. It has a built-in ICON utility that allows you to view any icons. This includes icons of any size and any number of colors up to 16 (4 planes). It has a built-in FONT utility that allows you to view all your disk fonts in four different resolutions. It has a built-in SOUND utility that allows you to play IFF sound files. It has a built-in CATALOGUE utility that allows you to list the contents of an entire directory or HD partition. The files are listed with their entire paths, their sizes and their dates of creation. You have the option of saving the catalogue to a desirable file name. It has a built-in FAST FILE READER with several menu items. It allows you to CONFIGURE it so that it carries your own 4 colors and your own 14 drives. YOU MUST HAVE THE FOLLOWING FILES IN YOUR CURRENT "c" DIRECTORY: ARC, CD, EDIT, ENDCLI, EXECUTE, LHARC, LoGG.file, PAK, RUN, STACK, WARP, ZOO for a fully operational LoGG. Naturally, some of these files might be built- in with the new software 2.0. You must name your respective files exactly as above. For example, you must name your favourite editor EDIT, etc. ***The files CD, ENDCLI, EXECUTE, LoGG.file, RUN and STACK are absolutely necessary for the program to run with most of its basic functions operatio- nal.*** LoGG looks for the file "LoGG.file" in your current directory as well as your "c" directory. The program will abort if it does not locate this file. In what follows, CLICK means PRESS THE LEFT MOUSE BUTTON. TO RUN IT FROM THE CLI: PRESS "LoGG". TO RUN IT FROM THE WORKBENCH: CLICK INTO LoGG'S ICON. TO EXIT: CLICK INTO THE "EXIT" GADGET, OR CHOOSE "QUIT" FROM THE MENU, OR PRESS CONTROL-Q. If you change your LoGG icon, please remember to enter the data in the TOOL TYPES gadget in the new icon as they appear in the original one. The icon that LoGG comes with opens a 1 pixel window on your WorkBench just in case LoGG needs to put some output somewhere. * $$$ ATTENTION $$$ * * * * Read below about changing the COLORS of LoGG, or its DRIVE * * NAMES. It is all VERY SIMPLE!!! * A) CHANGE DRIVES: Just replace the fourteen drive names on the first two lines of LoGG.file by the drive names of your choice. Leave one space between two consecutive drive names. You are allowed to use the same drive name as many times as you wish. B) CHANGE COLORS: The third line of LoGG.file contains the (HEX) numbers: "0 3 5 0 F F F 8 0 9 0 0". These are the 4 colors of LoGG: Dark blue: 035, Turquoise 0FF, Gold: F80 and Red: 9 0 0. You use the PALETTE program on your WorkBench to modify the colors of LoGG as follows: Run LoGG, select PALETTE in the file listing on the left and then click into the RUN gadget. The palette will fall on the screen of LoGG. Change the colors as you please. Each time you modify a color, pick up the 3 numbers representing that color. These are the 3 numbers on the right in the palette window. For example, if you see 3EF, the 3 numbers are 3, E, and F. Put these 12 numbers on the third line of LoGG.file and... voila! You've got your own colors! Put the numbers in exactly as you see them in LoGG.file right now. For example, change the last color "9 0 0" to an exotic green "4 F 4". Remember to choose CONFIGURE from the menu so that LoGG can adjust itself to the change. If you put any drive name in the source or destination gadget and then you press <RETURN>, the program will try to attach to that drive. Also, if you CLICK QUICKLY TWICE INTO ANY DIRECTORY name of the listing, you get attached to that directory. You can execute ANY VALID COMMAND as follows: click into the EXEC-CLI gadget. Then enter the command into the gadget provided, and press <RETURN>. Please note that when you are running a program from EXEC-CLI, its output (if it has any) might appear on the screen behind LoGG. So, if you expect any such output, click into the depth gadget in the upper right corner to see it. You MUST CLICK OFF ALL INFORMATION WINDOWS that appear on your screen. To get to the WorkBench from the HIRES screen, just click into the depth gadget in the upper right corner of your screen. To return to your HIRES screen, just press: LEFT_AMIGA-M. It is faster to use your archiving functions in RAM:, RAD:, VD0: or VDK:. MENU 1: TOGGLE FONT: Allows you to replace the font used for the listing of files by a built-in font. This item can be useful when one is obliged to use the HIRES screen. This font will not be as fast as the default TOPAZ 8 font when FastFonts is in action. FastFonts will not speed up the operation of the built-in fonts. THe use of FastFonts is recommended with AmigaDos 1.3. MEMORY: Displays the available FAST and CHIP memory. It also displays the LARGEST chunk of contiguous memory as well as the TOTAL mamory (FAST + CHIP). MOUNTLIST: This item shows you your own MountList from memory. This means that the LoGG file reader is used to show you the list of the mounted devices from memory, not by reading your Mountlist in your devs directory. VOLUME INFO: You use this item to get the LoGG INFO routine listed by the file reader. This is a built-in INFO command. VOLUME STORE: This menu item shows you the available storage in bytes on all your volumes. This is an important item that you need to use when you MOVE or COPY files, etc. CONFIGURATION: You may edit your LOGG.file by choosing the EDIT option, and then you may establish those changes in the program by choo- sing the UPDATE option. COPY OPTION: This option allows you to list all files that are being co- pied or moved. LIST is the default option. Just select NO LIST to abort the listing. WORKBENCH: This menu item can be used to practically reduce the prog- ram to a small window with a little icon on it. This will allow you to work comfortably in the back. When you want LoGG back, just click into the icon on that window once and you are back EXACTLY where you were before you closed shop! ABOUT: Availability and support information. QUIT: Exit the program. MENU 2: SAVE LIST: This item allows you to save the current file listing. A string gadget will be used for the desired destination file name. You may omit the names of the directories by choosing the NO DIRS subitem. You include those names by selecting ALL FILES. PATTERN MATCH: Assume that you want to highlight all the files that contain the string ".bat" in their names. Just enter ".bat" (no quotes, of course) in the gadget. The program will check every file in the current directory and will highlight its name provided that it contains the string ".bat". After having done that, you can now operate on these files nicely. You may DELETE THEM, ARC THEM, SHOW THEM, etc. SET FILEDATE: LoGG will set the current date on your computer on all of the highlighted files. If you want the actual current date set, you must set that date on your computer by using the DATE command. PTOTECT ALL: This menu item allows you to set the desired protection bits on all of the highlighted files. A separate window will open with 8 gadgets representing the 8 protection bits. HIGHLIGHT: We have found that the Amiga user needs a variety of high- lighting possibilities. Thus, we have included this menu item with six subitems representing 6 different highlighting situations. DISPLAY SIZE: You enter a number in the gadget provided and the program highlights all files of size >= that number. The idea be- hind this is to highlight all files larger than a given size in order to process them separately. The rest of the files can of course be highlighted by using COMPLEMENT in the previous menu item. PATH IN BYTES: You may get the size of the current path in bytes by select- ing ENTIRE PATH. Selecting HIGHLIGHTS, you get the sum total in bytes of all the files selected. This includes simple files as well as directories. This is an important aid to your COPY and MOVE functions. MENU 3: FIX ASCII: You choose this item after you highlight an ASCII file name that you want fixed. This means that you want to eliminate all carriage returns in that file. LoGG will try its best to do this and will give you a copy of the corrected file in RAM:. The corrected file will be called ASCII_OUT. You do the same thing by READing the file and then selecting FIX TEXT from the menu of the LoGG READER. REPLACE STRING: We have added this menu item because we feel that the Amiga user needs, occasionally, to change all the occurrences of a string in a binary file. Suppose that a program shows always DF0: in one of its requesters and you want to change that to DH0:. Just select this menu item and enter DF0: DH0: in the requesters gadget. LoGG will do the rest. Naturally, you should keep a copy of the file to be changed just in case you make the wrong substitution. All these changes can be checked out by HEX EDITING the file with the appropriate menu item below. LOCATE FILE: This is of course a very common need. You want to find a file in your current drive/directory. Just enter the desired file name in the gadget and let the program search for it. The program will search everything in this path. The current directory and its subdirectories. It will noti- fy you whether it has found the file. It will also exhibit the file's exact path so that you can work with the file. If you choose "FIND ALL", the program will actually give you all the files in the current path with the desired name. LOCATE STRING: This item performs the same type of function as the previous item: it looks for a file. However, this time you do not know the exact name of the file. You only know part of the name. Thus, you enter the string that you know in the requester gadget and the program will search every file name for this string. "FIND ALL" and "ONCE ONLY" have the obvious meanings. SEARCH STRING: This useful feature allows you to search all the files in the current directory for a given string. You need this when you have seen something written somewhere, but you do not remember where. (1) No Files Have Been Highlighted. If you choose FIND ALL, the program will find all the the files that contain the string. Otherwise, it will exit this feature when it locates the the first such file. Subdirectories are not included here. If there is such demand from the users, we will include subdirectories in the search in the near future. Also, the search of a particular file terminates when the program has found the string once in that file. (2) Files Have Been Highlighted. LoGG will operate as above, but now it will only search the files that you have highlighted in the current front panel window. The program will not search binary files at all. EXTRACT ASCII: You can extract all ASCII characters from a binary file by using this item. The program will put these extracted ASCII strings in a file in RAM: with the name EXTRACT_ASCII. TEXT ANALYSIS: This menu item will give you an elementary text analysis of a text file. Most probably, it will be used to count the number of words in the file. ASCII TABLE: Here is the ASCII TABLE for the Amiga Computer. You may now use your keyboard keys in various applications and in the HEX, DEC, OCT and BIN bases. HEX EDITOR: This is one of the two major changes in LoGG 1.2. This fea- ture enables you to actually EDIT any BINARY file. This means that you can edit the file's hexadecimal representation as well as its decimal representation. Each Amiga character is equal to a BYTE. For example, E = 45, H = 48, l = 6C (= 108), and m = 6D (= 109). If you want to change some ASCII word in the file, say "FLOWER", to the word "MARINE", just click into the letter "F" (of the word "FLOW- ER") inside the right panel and then just type in "MARINE". You must remember now that the number of letters you are writing into the right panel must equal the number of letters tht you are replacing. If you go any further inside a binary file, you will destroy the checksum number of that file. So, change the ASCII words by words of the same number of letters. The same remarks apply to the HEX representation on the left panel. That panel accepts only HEX digits, i.e., 0,1,2,3,4,5, 6,7,8,9,A,B,C,D,E,F. These are the numbers from 0 to 15, i.e., the digits of base 16. To write a BYTE into the left panel, you need two strokes of the keyboard. A lot of the HEX numbers that you write this way have no printable equivalents. So, for these BYTES, you just get a little square in your right panel representation. You may use the ARROW KEYS to move your cursor in any direc- tion on your panels. Just click anywhere and then use one of these keys. Pressing continuously on such a key causes the cursor to move continuously on the panels. There are several gadgets and a menu on your HED editor. Here are the gadgets: UNDO: Undoes all changes made. SAVE: Saves al the changes made on either panel. FORWARD: Displays the contents of the next page. BACKWARD: Displays the contents of the previous page. START: Brings you back to the beginning of the file. END: Displays the last page of the file. The menu: SEARCH: When you select HEX, you are looking for a HEX string of digits. For example, "EFDA12" or "2134". Since you are actually searching for strings of BYTES, you must always enter in the requester an even number of HEX digits to search for. If LoGG locates that string, it will dis- play the appropriate page with that string high- lighted. It will also highlight all other occur- reneces of the string on that page as well as the ASCII equivalents on the right panel. Similarly, the selection of ASCII will give you the highlights of the first page containing the ASCII string that you have entered in the re- quester gadget and the HEX equivalents on the left panel. CONTINUE SEARCH: This item allows you to continue the search of a HEX/ASCII string without having to enter that string in the requester gadget again and again. GO TO: Just enter a number in the requester gadget and the HEX editor will try to display that sector on your screen. Nothing will happen if the number is invalid. The HEX EDITOR displays also: the SECTOR number (in DEC), the OFFSET of the first HEX BYTE (or the first ASCII cha- racter) within the display page, the CURSOR POSITION (HEX) within the current page, the current MODE (HEX or ASCII), and the FINAL SECTOR number (DEC). MENU 4: CATALOGUE: Here is an important menu item. It lets you CATALOGUE the current path. It forms an alphabetical listing of the entire contents of the current path. The listing contains the file names with their complete path name, their sizes and their creation dates. The LoGG file reader is used to bring the catalogue to your screen. You will have the option to save the catalogue to a desirable file name. A valuable tool when you want to look at and/or save the contents of an entire HD partition, for example. PLAY SOUND: This feature is used to play IFF sound files. All you have to do is attach to the directory with those files and high- light the ones that you want to listen to. Click into the STOP gadget to stop the playing of sounds. SPEECH: This is the second major feature of Version 1.2. You may now experience the SPEECH utility of your Amiga in its full strength. In order to hear your Amiga speak, just enter a phrase in the ENGLISH gadget, click into the TRANSL. gadget, and then click into the SPEAK gadget. That's it. You may change the various parameters of sound (FREQUENCY, RATE, PITCH, VOLUME) by using the appropriate sliders, and the pa- rameters of voice (MALE, FEMALE, ROBOT, HUMAN) by clicking into the appropriate gadgets. The DEFAULT gadget will bring you back to the original settings. SHOW FONT: Another strong feature of LoGG. Get to the fonts: directory, or any other directory with fonts, click into the name of the font (this is the directory of the font, not the ".font" file) and highlight the font sizes that you want to view. As you see, you may show your fonts in 4 different resolu tions. Click into the font window to close it and choose STOP SHOW from the font window menu to stop the showing of fonts. SHOW POINTER: This is a new feature of LoGG 1.2. When you select this menu item, you are actually looking at the various pointers in the highlighted system-configuration files. Such files can be obtained by HERMiT (a HERMES program that actually saves the pointer of the front window into such a file), or any other program that saves pointers. SHOW ICON: Well, after IFF pictures and sounds and fonts, it is only natural to be able to show your icons. This feature will show any icons (of any size and resolution up to 4 planes). It will show the FRONT or the ALTERNATE icon. It will also show BOTH if it can fit them in the same screen. This item shows only a single icon. Click into the icon window in order to close it. For a sequence of icons, you use ICONSHOW instead. ICONSHOW: You use this item in oder to show a sequence of highlighted icon files. The program shows the FRONT and the ALTERNATE image of the icon if it can fit them both on the screen, otherwise it shows only the front icon. Click into the icon window to close it and choose STOP SHOW from the icon window menu to stop the showing of icons. GADGETS: 14 DRIVES: Clicking into any one of these gadgets will list the files in the corresponding volume in the current SOURCE window. If you don't like the volumes used, just enter your own 14 volumes in "LoGG.file" as described above. S: SOURCE gadget. Here you see the name of the drive/directory you are currently attached to. Also, if you enter a path name in this gadget and then you press <RETURN>, you get to be attached to that path, provided it is a valid one. To make this the DESTINATION window, just CLICK into the other (opposite) vertical gadget. If you do this, the other window becomes the SOURCE window. D: DESTINATION gadget. Here you see the name of a desti- nation drive or directory. It is used by COPY and MOVE. Also, if you enter a path name in this gadget and then you press <RETURN>, you get to be attached to that path, provided that it is a valid one. In this case this gadget becomes automatically the SOURCE gadget. In order to make this window the SOURCE window, all you have to do is CLICK into its vertical (proportional) gadget or anywhere inside the window. Also, every time you click into a file name or doubleclick into a directory on this window, you get this window changed into the SOURCE window automatirally. DEFAULT GADGETS: ALL: Highlights all files on the current window except directories. CLEAR: Removes the highlighting from all files and directories on the current file display window. EDIT: Edits the file that you have highlighted in the current window. The program will notify you if you try to EDIT the wrong file. EDIT is of course the name of your favourite editor residing in your current "c" directory. BYTES: Displays the sum total of bytes of the files that have been highlighted in the current window. No directories are included. If you want the size in bytes of the current path, please choose the menu item PATH IN BYTES. PARENT: Moves up one step in the directory tree. It will stop moving when it hits a root directory. SHOW: Shows the pictures you have selected. A little slideshow is possible by just highlighting the pictures that you want to show in a sequence. Choose STOP SHOW from the SHOW menu in order to stop the showing of pictures and click into the picture window in order to close it. STOP: This is an extremely important gadget. It can save you a lot of trouble. It just stops the current file operation. It stops the MOVE and the COPY operations. It stops the SEARCH and LOCATE FILE operations. It stops the program from conti- nuing with the CATALOGUE process, etc. It will NOT STOP THE FORMAT and DISKCOPY operations. These are controlled by the little panels on the respective windows. We have noticed that it is possible sometimes to even stop LoGG from a READ/WRITE ERROR situation. When you try to copy into a bad sector of a disk, you will start getting a READ/WRITE ERROR requestor on your screen. This seems to go on forever. We have noticed that if you press the STOP gadget several times and keep clicking the requestor off, you might be able to save your Amiga from a reboot and your- self from the loss of valuable data. READ: This is a fully operational file reader. It will list the selected file and will scroll through it very fast. The reader forms new lines out of lines which are more than 78 characters long. It has 8 menu items. We will only elabo- rate on the items that need some explanation. Just remember that YOU CAN SCROLL THE TEXT UP AND DOWN BY USING THE RESPECT- IVE ARROW KEYS or by CLICKING into the upper or lower half of the reader screen. (1) GO TO LINE: You can choose this menu item, or just press RIGHT_AMIGA-G instead. As soon as you do that, the GOTO-gadget clears up. Just go ahead and type in the line number you want to see. Then press <RETURN>. The program will then try to exhibit that line as the top line of the page. Another way of doing this: Just click into the GOTO-gadget, clear it up by using the BACKSPACE key (or pressing RIGHT_AMIGA-X), enter the line number that you wish to exhibit, and then press <RETURN>. The program will do nothing if the line number that you have entered does not exist. (2) FIND STRING: You can choose this menu item, or just press RIGHT_AMIGA-F instead. As soon as you do that, the FILE-gadget clears up. Just go ahead and type in the string that you want to see. Then press <RETURN>. The program will then try to exhibit that string at the top line of the page. Another way of doing this: Just click into the FILE-gadget, clear it up by using the BACKSPACE key (or pressing RIGHT_AMIGA-X), enter the string that you wish to exhibit, and then press <RETURN>. The program will do nothing if the string that you have entered does not exist from the current line on. (3) SEARCH AGAIN: Well, now that you have found the string, just choose this menu item or press RIGHT_AMIGA-S to try to find the string again. The program will try to locate the string and exhibit it at the top line of the page. Again, the program tries to locate the given string starting from the secong line of your page down to the end of the file. Please note that the file reader recognizes only 8-space tabs. If it sees any other tpye of tab, it will replace it by an 8-space one. COPY: Copies all the files that you have selected in the SOURCE window into the DESTINATION Directory/Drive that you have (or the program has) entered in Gadget "D". This includes the highlighted directories in the SOURCE window. This function can be stopped by use of the STOP gadget above. When you STOP the copying process, you should note that the last uncopied (or partially copied) file is the first of the remaining highlighted files. It is safe to assume that this file/directory has not been copied to the destination path. Another important note here is that you do not have to attach to the destination in order to copy the source to it. Just enter the destination path in the "D" gadget. For example, let "RAD:HELLO" be the path for the listing on the left window. Suppose that you want to copy the high- lighted files in "RAD:HELLO" to the directory "RAM:GOOD". Just enter "RAM:GOOD" in the "D" gadget then click into the COPY gadget. When LoGG finishes copiying, it will flash the "RAM:GOOD" directory in the destination window. If you get a system requestor with a DISK FULL message, while you are copying, just click into the STOP button to stop the process. The above remarks on the STOP gadget apply to the STOP gadget on the window that opens when you have chosen LIST from the COPY OPTION menu item. You must click into the STOP gadget before you can use the CONTINUE and CANCEL gadgets. MAKEDIR: Creates a new directory with the name that you have entered in the gadget. Paths are accepted for this name. The program will notify you whenever it cannot create the new directory. RENAME: Renames a selected file or directory. The new name is what the user enters in the requestor string gadget PRINT: Sends the files you have selected to the printer. The process does stop if you use the STOP gadget, but please remember that this cannot happen instantly. The routine that prints your file reads 512 bytes before it starts print- int. Thus, LoGG will not "hear" your STOP message until it has printed those 512 bytes. DELETE: This is another important and necessary gadget. You must use it very carefully because you can delete valuable files when you click into it. This is why we have included a safeguard. LoGG always asks you if you "really want to delete the high- lighted files". You can stop the deletion of files via the STOP gadget, but do it quickly because the files get deleted very fast. Directories are included here. FILEINFO: LoGG has a very nice way of modifying the PROTECTION BITS and the COMMENTS of your files. It opens an entire independ- ent window for this job. Just highlight the files that you are interested in and then click into this gadget to start processing them. If you want to save the current data of a file, just click into the "DO IT" gadget. If LoGG cannot modify the PROTECTION BITS and/or the COMMENT of a file, it will tell you so in a requester and it will state the reason, if possible. If it says nothing after you press "DO IT", the change has been saved. The selected (highlighted) gadgets allow for the respective operations. For example, if DELETE is selected, then the file CAN BE DELETED. Thus, a file which the "list" command classifies as "----rwed", will appear on your FILEINFO window with the following gadgets selected: READ, WRITE, EXECUTE, DELETE. You can exhibit and manipulate the file info on any file residing anywhere. All you have to do is get in the FILE gadget, enter the file name (entire path), and then press <RETURN>. You may CANCEL all the changes you have just made on your FILEINFO window by pressing the CANCEL button. Naturally, we assume here that you have not pressed the "DO IT" button after these changes were made. The NEXT button allows you to move on to the next selected file in your active window. The TYPE gadget is referring to the type of file that you are examining, i.e., ASCII, Binary, Manx Object, IFF, Icon, etc. Naturally, it is virtually impossible for a program to be able to exactly identify every given file for the Amiga computer. The reason for this is that new files are constantly produced by new Amiga applications. We have tried to include as many types as possible without generating too much overhead. One application of FILEINFO is setting the PURE bits for SHELL-RESIDENT programs. Another application is getting the actual date of creation of a file in order to identify the most recent copy, etc. You also need this option in order to get the full name of a file that is only partially listed in one of your panel windows. FILE TYPES RECOGNIZED BY LoGG: .info 8SVX Sound ABSOFT-compiled AmigaBASIC AEGIS DRAW Drawing AmigaBASIC ACBM Picture AmigaBASIC Binary Animation ARC ASCII Binary Binary Executable DIGIVIEW RGB DIRECTOR (.film) DMCS Music FANTAVISION Animation FLOW (Normal) Text Font Header GIF Picture Icon IFF Picture Lattice C Object LHARC LHWARP MANX Object METACOMCO Pascal Object Music Instrument (.ss) Online! (.trm) ORGANIZE! Database (.dbf) PAK PHOTON PAINT Brush PHOTON PAINT Picture POWER PEAK-crunched Data POWER PEAK-crunched Executable Printer Driver PROWRITE Document SCULPT-3D Ray-trace SCULPT-4D IFF Custom FORM SHAM Picture SMUS Music WARP WORD PERFECT Text ZIP ZOO FORMAT: You use this gadget when you want to FORMAT a disk drive. LoGG can format floppy disks in DF0:, DF1:, DF2:, and DF3:. You can enter the name of the resulting formatted disk in the string gadget of the requestor. If the VERIFY gadget is not highlighted, the formatting is naturally quite faster. If you click into the QUIT gadget while formatting a disk, you are given one more chance to continue before formatting is stopped with the destination disk probably corrupt. The QUIT gadget is included of course because you might be formatting ... the wrong disk. LoGG will attempt to give you a reason as to what went wrong with the formatting of a disk if it cannot continue the process. If you want the name of the formatted disk to be something other than "Empty", you should enter that name in the gadget provided with the FORMAT window. LoGG will attach to the formatted disk the name that appears in the buffer of that string gadget. DISKCOPY: You use this gadget when you want to DISKCOPY a floppy disk in one of the drives DF0:, DF1:, DF2:, DF3: into a floppy disk in another one of the same drives. Again, if the VERIFY gadget is not highlighted, disk-copying is consider- ably faster. However, we would like to suggest that you use the VERIFY option in both formatting and disk-copying. LoGG will attempt to give you good diagnostics if something goes wrong with disk-copying. RESOL: This gadget can be used to change the resolution of your screen to HIRES (640x400). This is actually neccessary if you have more than 800 files and directories in a single path. Naturally, that many files in a single path are not suggested because of reduced safety if something goes wrong with the hard disk. If you do not have to use the HIRES option, it is better to work with the main panel (MEDIUM RESOLUTION, 640x200). This is because less memory is needed for LoGG and the program does not have to resort to sending the screen to the background each time it needs to. MOVE: Exerything said about COPY applies here with one exception: MOVE WILL OVERWRITE DUPLICATE FILE NAMES. Also, MOVE will DELETE all the files that it has copied into the destination path. So, be careful when using this command and remember that the STOP gadget will freeze the process. If you do use the STOP gadget, the first highlighted file/directory is the last one that has not been entirely copied into the desti- nation path. As in the COPY case, you do not have to have the destination path actually listed in the "D" window before you copy into it. Just enter the path in the "D" gadget and then click into MOVE. If you get a system requestor with a DISK FULL message, while you are moving files, just click into the STOP button to stop the process. STORAGE: It displays the available BYTES in the SOURCE as well as the DESTINATION gadget. BLUES: This is fun! Just a little play with the COPPER LISTS in order to get those blues on the screen without changing its depth and without slowing the program down. If you do not like the BLUES, just click them off! RUN: Runs any file you have selected provided that it is a runable file. You must make sure there is enough memory to run that program. There is no reason to run a huge program from LoGG. You need all the memory that you can get in such a situation. LoGG actually opens a fairly sized CLI whenever it runs a file. It does this because the program you are running might require a CLI to send its output to and receive its input from. However, the CLI will close after the running external program is finished. If you want to use the RUN function with a CLI that does not close, you should use one of the PARMS gadgets instead with an appropriate CLI. For example, suppose that you want to run the programs listed on your screen with a SMALL CLI window that does not close after the programs are finished. Just make a new PARMS gadget called RUN and right under it write "% (SMALL)". That's it. Whenever you RUN any program listed, by using this gadget, you will get the program running on its own CLI which you will have to close by entering EndCLI. NEWCLI: LoGG opens its own NEWCLI window. It is an actual CLI where you can work as if you were on the command line. Remember, our NEWCLI's do not remember commands that reside in assigned paths. Only commands in the current "c" directory. You can get rid of the NEWCLI by just pressing "ENDCLI" into it. Please do not use the RUN gadget to run the NEWCLI command that comes with your Workbench disk. Use LoGG's NEWCLI gadget instead. Although we could have the CLI's in the resolution of the front screen (possibly HIRES|LACE), we preferred not to introduce that feature because the user might run programs in this new CLI that require the WBench screen. This feature is actually incorporated in the new version of the HERMiT program (copyright A. G. Kartsatos). EXEC-CLI: It executes any CLI command that you enter in the requestor gadget. For example, if you enter in the gadget: "Run DH1:DELPAINT/Dpaint", you are running the program Dpaint residing in the directory DH1:DELPAINT. Now remember! You cannot always do this. If you enter "Run DH1:SONIX/Sonix" instead, you are not going to be able to run Sonix. This is because the Sonix program looks for files like Scores, etc. If it doesn't find them, it does not load! Even if you press: "cd DH1:SONIX" and then you come back with "Run SONIX" it will not work! You know you are at "DH1:SONIX" but SONIX does not know that. In this case, you should use the MACROS gadgets as we have indicated in the LoGG.file. CAUTION: When you run LoGG by its icon, you should include the entire pathname for the files you might use in the command in the requestor gadget. EXIT: Exits LoGG permanently. You can also EXIT by choosing the "QUIT" menu item or by just pressing "CTRL-Q". ARCS GADGETS: These are self-explanatory. A word of caution about UNPAK. You might not see all unpaked files when UNPAK is done with a ".PAK" file. Just refresh your listing in a few seconds to see them all. MACROS GADGETS: In the file LoGG.file these are Entries 1 - 24. Each MACRO is nothing else than a sequence of commands written one after the other vertically. None of these commands accepts any parameters. The PARMS commands are described below. Only the first command in a MACRO should contain the "CD" command. This "CD" command should be the first token on the corre- sponding line. Please have a look at the examples in LoGG.file. Each MACRO can have up to 7 commands in it. The title of a MACRO in LoGG.file consists of exactly 10 characters. The last character is a "*" and the name of the macro must be at most 8 characters long. Thus, there is always at least one space between the name of the macro and the "*" at the end. A MACRO does accept CLI windows at the very end of the first command entry. You can open a tiny CLI window by entering (TINY), a small CLI window by entering (SMALL) and a large (full page) window by entering (FULL). This CLI token whould be the last string in the first command line of your MACRO and it should be at least one space away from the previous string in that command. You open a TINY CLI if the program you are running is not interactive (i.e., it does not communicate with the user on the command line), but it might use the CLI for some output (usually, if some- thing goes wrong). You do not need to open any CLI if you know that the program that you are running does not write to the command line at all. You open a SMALL CLI if the prog- ram that you are running is interactive (e.g., prompts you for a response, etc.), but you do not need a full page for that conversation. You need to open a FULL CLI if you want to have the entire page at your disposal. For example, the program MORE on your WorkBench disk, can show you a doc in entire pages if you run it with a FULL CLI. Please do not use the RUN command in your MACROS entries. LoGG WILL OPEN ITS OWN CLI (if you specify TINY, SMALL or FULL) anyway. PARMS GADGETS: In the file LoGG.file these are Entries 25 - 48. Each entry has a gadget title as before (see below) under which the user can enter a command with up to 2 parameters. For example, if you want your own gadget with the command FIXOBJ in it, just use the title "FIXOBJ *" in the corres- ponding position of LoGG.file and under it add "Run Fixobj %s %s" without the quotes of course. The symbols "%s %s" stand for the two parameters that Fixobj needs. The first one is the filename and the second is the new filename. The first parameter is the name of the file that you have clicked in the table of files on the left, and the second is a string that you must enter in the requestor gadget. For example, to Fixobj the file "HELLO" with new name "GOODBYE", select "HELLO" from the table of files, click into the FIXOBJ gadget, and then enter "GOODBYE" in in the requestor gadget. One-parameter commands will contain only one symbol "%s" and that can be a filename from the table of files or any name in the requestor gadget. It is important to note here that each PARMS command must contain *at most 5* tokens. For example, the command HELLO %s HERMES JULIE %s (R) (TINY) (5 tokens) is OK, but the command HELLO %s HERMES JULIE %s GEORG (R) (SMALL)(6 tokens) is wrong. The symbol "(R)" here means that you want to have the files refreshed after the execution of this command. The symbol "(R)" must be placed at the end of your actual command and before any CLI token like (TINY), etc. We suggest that you use of this symbol only if you really need to refresh the file listing. Otherwise, it would be a waste of time. If you have a command like HELLO %s HERMES %s %s JULIE which is illegal under the present setting of LoGG, you could still enter it as HELLO %s HERMES %s JULIE and then enter two strings in the requester gadget instead of one. This way you may be able to include many more possibi- lities in a PARMS situation. The title of a PARMS entry in LoGG.file consists exactly of 10 characters. The last character is a "*" and the name of the command must be at most 8 characters long. Thus, there is always at least one space between the name of the command and the "*" at the end. The PARMS entries can contain a CLI token exactly as in the above MACROS description. This should be the last token of your command and at least one space after the previous string. For example, HELLO %s HERMES %s (R) (TINY) works fine with LoGG. Please do not use the RUN command in your PARMS entries. LoGG WILL OPEN ITS OWN CLI (if you specify TINY, SMALL or FULL) anyway. A certain amount of experimentation will certainly help here. THINGS TO REMEMBER: 1) To prepare your own command sequences, remember the following: LoGG.file finishes always with an empty line. Each gadget name contains exaclty 10 characters. This includes the star ("*") at the end of the name of the gadget. The actual gadget title is up to 8 characters long. There is always at least one space between the actual gadget title and the "*" at the end of the entry name. Right after each custom gadget name you may put your own commands. Each line will contain ONLY ONE COMMAND. Do not string them together! For MACROS, you can afford up to 7 commands under each gadget name. However, only the first command can contain the "cd" command in it, and when it does it is always the first token. There is only one command line for each PARAMS gadget. At the end of the sequence of commands under a gadget you MUST INSERT AN EMPTY LINE. It is possible to use PARMS commands like MACROS. However, you should have in mind that LoGG opens always a CLI window with each PARMS command. 2) Sometimes your LoGG.file gets funny with some, possibly invisible, characters in it. LoGG loads but does not read that file right. To correct this problem, just run the file FIX_FILE in a directory containing your LoGG.file. This little program will attempt to correct your LoGG.file and put the corrected contents in a file called LoGG.file1. Just rename LoGG.file1 as LoGG.file and continue as usual. 3) Use FastFonts with this program. The text operations become much faster. FastFonts is on your Workbench disk. This is for AmigaDos 1.3 only. 4) Do not use the ARC, PAK, ZOO, LHARC programs with output in directo- ries with many files. Refreshing of the windows is faster on smaller di- rectories. Also, these ARC programs work faster when they are loaded and have outputs in RAM:, VD0: or RAD:. 5) If you get a little confused about the exact name of a file which is not completely listed, just select the file and click into the FILEINFO gadget. The FILEINFO gadget contains the entire name of the file and other file information. (6) Whenever a CLI appears in the execution of a command or in an archiving process, you should close it by pressing EndCLI. It is important that you have this command included in your "c" directory. (7) If a program like Preferences changes the colors of your LoGG program, just select CONFIGURE from your first menu, after that program is off, to see your default colors back. (8) WARP will warp your entire disk (track numbers 0-79). If you want to warp other tracks, you should make a WARP PARMS gadget as indicated in your LoGG.file. Just put "WARP Read %d" as a command there. When the requestor asks you for a paramer value, insert, for example, "0 11 RAD:MARY". WARP will then put the resulting file MARY.WRP in your RAD: volume. This file will contain the tracks 0-11 of your disk. (9) It is true that you can afford a large number of parameters for a PARMS entry if these parameters are in a sequence as above. (10) If the disk you have just inserted (or a path on it) is listed in one of your front panel windows, you should refresh that window's listing by using the SOURCE or DESTINATION gadgets, or by clicking into one of your drive gadgets. To see why you need to do this, suppose that you have listed "DF1:" in your DESTINATION gadget. Now, suppose that you insert a new disk in "DF1:" (not the one you have just removed). Then if you do not refresh the DESTINATION window, LoGG will think that the current listing there is the listing of the disk that you have just inserted. Although no damage can result from this, you can get a confusing listing of files and directories in that window if, e.g., you try to copy files there. LoGG will notify you to refresh your window(s) whenever disks have been inserted or modified (via FORMAT, DISKCOPY, etc.). (11) Please avoid using names of directories and files that contain empty spaces in them. You can always replace, for exampe, "HELLO JOHN" by "HELLO_JOHN". Certain archiving programs (among others) do not work right with such names. Although LoGG will do its best to work with such names (in the first 48 built-in gadgets), there is still some overhead in trying to do so. For support on this and other programs by HERMES, please write to: A. G. Kartsatos 8524 Caladesi Island Drive Temple Terrace, FL 33637-7310, USA *** <<<-->>> *** DISCLAIMER FOR LoGG 1.2 ======================= The usual disclaimers concerning computer software apply to this product. Although this program has been tested extensively for its accuracy and reliability, the author will accept no liability whatsoever for any damage resulting from the use, misuse, or excessive use of it.